home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / stack17.zip / ST!SYSOP.DOC < prev    next >
Text File  |  1991-11-22  |  11KB  |  266 lines
  1.     //////////////////////////////////////////////////////////////////
  2.     /                                                                /
  3.     /                        S t a c k ' E m !                       /
  4.     /                           Version 1.7                          /
  5.     /                                                                /
  6.     /                    (c) Copyright 1990 - 1991                   /
  7.     /                      << B-Ware >>> Software                    /
  8.     /                                                                /
  9.     /                                                                /
  10.     /       DOOR game for Wildcat!, PCBoard 14.x, RA/QBBS, GAP,      /
  11.     /       SPITFIRE  and  other BBS  software which  uses door      /
  12.     /       information files compatible with the above.             /
  13.     /                                                                /
  14.     /                                                                /
  15.     /                           Support BBS:                         /
  16.     /                          Gulf Coast BBS                        /
  17.     /                          (904) 563-2547                        /
  18.     /                         1200 - 14400 HST                       /
  19.     /                         FidoNet 1:365/12                       /
  20.     //////////////////////////////////////////////////////////////////
  21.  
  22.  
  23.     INTRODUCTION
  24.     ------------
  25.  
  26.     Stack'Em! is  a game where the player has to join different shaped
  27.     falling  pieces  together  to  form  completed  horizontal  lines.
  28.     Scoring is based on how many pieces are played and number of lines
  29.     completed.  Players  compete for weekly high  score as well as All
  30.     Time High Scorer.
  31.  
  32.  
  33.     FEATURES
  34.     --------
  35.  
  36.     - ANSI Color and Mono screens with animation
  37.     - Full multi-node support
  38.     - Support for locked DTE up to 38.4K bps
  39.     - Support for non-standard COM3 and COM4 ports
  40.     - DESQview aware
  41.     - Easy installation and no maintenance
  42.  
  43.  
  44.     SETUP
  45.     -----
  46.  
  47.     Setup  is  very simple.  Create a directory and  place  the  files 
  48.     STACKEM.EXE and ST!SETUP.EXE in this directory.
  49.  
  50.     Change to this directory and run ST!SETUP.  A screen with  several
  51.     fields  will be displayed.  There will be a box at the  bottom  of 
  52.     the  screen that will  display  help  information for each  field.
  53.     The  following  edit keys  are allowed: HOME, END, BACKSPACE, LEFT
  54.     and RIGHT ARROW. Use the ENTER,  UP  and  DOWN  ARROW keys to move
  55.     between the different fields.
  56.  
  57.     Each field is described below:
  58.  
  59.     Name: The name of the person registering the program as it will be
  60.     displayed on  the opening screen (when registered).  This does not
  61.     necessarily have  to  be the SysOp, it could be the name of a user
  62.     who donated the registration fee.
  63.  
  64.     BBS Name:  The  name of the  BBS  as  it  will be displayed on the
  65.     opening screen (when registered).
  66.  
  67.     Key Number:  If registered, enter your Key Number here.  Until the
  68.     program  is registered leave this field  as  all zeroes.   See the
  69.     registration section below for more information about registering.
  70.  
  71.     Allowable plays per day:  The number of plays per day that will be
  72.     allowed.  Zero (00) means unlimited plays per day.
  73.  
  74.     Display 'Next Piece' [Y/N]:  If 'Y', the next piece  to  be played
  75.     will be displayed to the player.
  76.  
  77.     Use the  'Doughnut'  piece [Y/N]:  If 'Y',  the  large  'Doughnut'
  78.     shaped piece will be used.  You may not want to use the 'Doughnut'
  79.     shaped piece if small children will be playing the game.
  80.  
  81.                                    Doughnut
  82.  
  83.                                     ██████
  84.                                     ██  ██
  85.                                     ██████
  86.  
  87.  
  88.  
  89.     Path and Name of ANSI Bulletin: Path and name for the ANSI (Color)
  90.     bulletin file. If left blank no file will be written.
  91.  
  92.     Path and Name of ASCII Bulletin: Path and name for the ASCII (Non-
  93.     Color) bulletin file.  If left blank no file will be written.
  94.  
  95.     COM3 (Base Address and IRQ):  If installed  enter the Base Address
  96.     in Hex (e.g. 03E8) and IRQ of COM3.
  97.  
  98.     COM4 (Base Address and IRQ):  If installed  enter the Base Address
  99.     in Hex (e.g. 02E8) and IRQ of COM4.
  100.  
  101.     After entering all of the information, press 'ESC'.  ST!SETUP will
  102.     ask if you want  to save the configuration  file.   If this is the
  103.     first  time  ST!SETUP  has been  run  or  you  have previously run
  104.     ST!SETUP  but  changed some of the information, press  'Y'.   This
  105.     will  create or update the configuration file  (STACKEM.CFG).   It
  106.     will also create a STACKEM.SCO file if one does not exist. This is
  107.     the score file and is needed for the program to run.
  108.  
  109.     ST!SETUP will then ask if you want to create the registration file
  110.     (STACKEM.REG).   The  registration  file will be needed  when  the
  111.     program is registered, so you will need to answer 'Y' at least one
  112.     time for this file to be created.  Please be sure all  information 
  113.     is correct as your 'Key Number' will be based on this information.
  114.  
  115.     Consult  your  BBS manual for how to create DOOR batch  files  for 
  116.     your  BBS.   STACKEM.EXE must  be started from  the  directory  it
  117.     resides in for the game to function.  The command line for calling 
  118.     Stack'Em! is as follows:
  119.  
  120.     STACKEM STACKEM.CFG 'Full path and name of BBS information file'
  121.  
  122.     'Full path and name of BBS information file'
  123.  
  124.     This  will be the full path and filename of your  BBS  information 
  125.     file.   For  example:  C:\PCB\PCBOARD.SYS.   Stack'Em!  uses  this
  126.     filename  to  determine the BBS software which is  being  used  as 
  127.     follows:
  128.  
  129.     CALLINFO.BBS (Wildcat 2.xx)
  130.     PCBOARD.SYS  (PCBoard)
  131.     DOOR.SYS     (GAP, Wildcat! 3.0 and other systems using DOOR.SYS)
  132.     SFDOORS.DAT  (SPITFIRE)
  133.     DORINFOx.DEF (RA/QBBS)
  134.  
  135.     Please  note that the DORINFOx.DEF file that RA/QBBS uses  is  not 
  136.     compatible with RBBS.
  137.  
  138.     An example of a batch file for PCBoard:
  139.  
  140.     CD\STACKEM
  141.     STACKEM STACKEM.CFG C:\PCB\PCBOARD.SYS
  142.     CD\PCB
  143.     BOARD.BAT
  144.  
  145.  
  146.     UPGRADING
  147.     ---------
  148.  
  149.     To upgrade from versions  1.5 or 1.6,  replace the old STACKEM.EXE
  150.     and ST!SETUP.EXE  files with the  new version 1.7  STACKEM.EXE and
  151.     ST!SETUP.EXE files.
  152.  
  153.     To upgrade from earlier versions follow these steps:
  154.  
  155.     1 - Replace the existing STACKEM.EXE with the new STACKEM.EXE.
  156.     2 - Delete your existing STACKEM.CFG.
  157.     3 - Delete your existing STACKEM.SCO.
  158.     4 - Run ST!SETUP to create the new STACKEM.CFG.
  159.     5 - Modify your batch file(s) for the new command line syntax.
  160.  
  161.     Multiple  configuration files are no longer necessary  if  running 
  162.     multi-node.
  163.  
  164.     BRUN45.EXE is no longer needed for this program.
  165.  
  166.  
  167.     ERRORS
  168.     ------
  169.  
  170.     Any  errors  which may occur  will be written to  the  STACKEM.ERR
  171.     file.  When possible, a descriptive error message will be  written 
  172.     to  STACKEM.ERR  with the exact cause of the error.  If the  error
  173.     cannot be resolved, call the support BBS (Gulf Coast BBS) and give 
  174.     the exact text of the error message in STACKEM.ERR.   All  support
  175.     is handled through the Gulf Coast BBS.
  176.  
  177.  
  178.     MULTI-NODES, NETWORKS, MULTI-TASKERS
  179.     ------------------------------------
  180.  
  181.     Stack'Em! v1.7 has been developed in a networked environment.  All
  182.     multi-node features have been thoroughly tested on multi-node sys-
  183.     tems using DESQview and Peer-To-Peer Local Area Networks. DOS 3.1+
  184.     full record and file locking is supported.  Multiple configuration
  185.     files are NOT necessary when running on multi-node systems.
  186.         
  187.     Stack'Em! v1.7  is DESQview  aware.  It is automatically detected,
  188.     screen and  keyboard I/O are  "well behaved",  and time slices are
  189.     given back to other applications where appropriate. Stack'Em! v1.7
  190.     has been tested with 3 nodes running simultaneously under DESQview
  191.     (all ports  locked at  38400)  with no  noticeable effect on other
  192.     nodes.
  193.  
  194.  
  195.     MISCELLANEOUS
  196.     -------------
  197.  
  198.     At the  beginning of  each week the score  file will automatically
  199.     be cleared and last week's high scorer will be determined.
  200.  
  201.     If you are using a high speed modem and have your com port LOCKED, 
  202.     the  program will not respond to keyboard input while  your  modem 
  203.     buffer is full.  This is normal.
  204.  
  205.     Stack'Em! may be played from the DOS prompt by typing:
  206.  
  207.     STACKEM STACKEM.CFG LOCAL
  208.  
  209.     Note the user name is hard coded as 'SysOp' and the bulletins  and
  210.     score file will not be updated. Also, play will not be limited  to
  211.     the allowable plays per day set in ST!SETUP. This mode is only for
  212.     testing.
  213.  
  214.     To turn on screen writing, if it is off, press any key.
  215.  
  216.  
  217.     REGISTRATION
  218.     ------------
  219.  
  220.     Registration is required if you choose to continue using this DOOR 
  221.     program.   After 60 days of running the program unregistered,  the 
  222.     score  file  will  cease to be updated.  However,  the  game  will 
  223.     continue  to allow players to play. This should be long enough  to 
  224.     determine if the program meets your needs and is popular with your 
  225.     users.
  226.  
  227.     When  registered, the '[UNREGISTERED COPY]' line will be  replaced 
  228.     with a 'Registered To:' message.  This will show the Name and  BBS 
  229.     Name from the STACKEM.CFG file.
  230.  
  231.     If the STACKEM.REG form was  not previously created,  run ST!SETUP
  232.     and have  it create  STACKEM.REG.  Check  this file to  insure the
  233.     information is correct.  If it is not, re-run ST!SETUP and correct
  234.     any errors.   Your Key Number is based on the information in  this
  235.     file and must  be correct for your Key Number to work.  When done,
  236.     print the form to your  printer.  Send  the completed  STACKEM.REG
  237.     form  along with your  check or money order for $15.00 (US) to:
  238.  
  239.                                 Jim Brewer
  240.                           9426 N. China Pink Way
  241.                          Crystal River, FL  32629
  242.  
  243.     Your  'Key  Number'  will be sent to you  promptly.   When  it  is 
  244.     received, run  ST!SETUP and enter the number.  Stack'Em! will then
  245.     be registered.  No other action is necessary.
  246.  
  247.  
  248.     WARRANTY & DISCLAIMER
  249.     ---------------------
  250.  
  251.     There  are  no warranties, express or  implied,  for  unregistered 
  252.     copies of Stack'Em!.  The author will  NOT  be held liable for any
  253.     direct,  indirect, incidental, or consequential  damage  resulting 
  254.     from  the  use  of  this  program.   Your  use  of  this   program 
  255.     constitutes your AGREEMENT to this disclaimer and your release  of 
  256.     the author from any form of liability or litigation.
  257.  
  258.     Registered  copies  of  Stack'Em!  are  warranted  to  perform  as
  259.     described  in this  documentation.  In the  event  Stack'Em!  does
  260.     not  perform as described, the author will elect to either rectify
  261.     the  problem or refund  the amount  paid, provided notification is
  262.     received within 30 days of registration.
  263.  
  264.  
  265.                                  - END -
  266.